<html>
<head>
<title>Approval Role - Vanilla Extension</title>
<style><!--
dd { margin-bottom: 1em; }
blockquote { margin: 1em; padding: 1em; border: 1px solid black; }
--></style>
</head>

<body>

<h1 id="top">Approval Role</h1>
<p>Approval Role is a Vanilla extension that allows admins to assign any role
to a new applicant on approval.</p>

<h2 id="toc">Table of Contents</h2>
<ul>
<li><a href="#install">Installing and Enabling Approval Role</a></li>
<li><a href="#use">Using Approval Role</a></li>
<li><a href="#quirks">Quirks and Gotchas</a></li>
<li><a href="#develop">Development</a></li>
</ul>

<hr />
<h2 id="install">Installing and Enabling Approval Role</h2>
<p>In order for Vanilla to recognize an extension, it must be contained within
its own directory within the extensions directory. So, once you have
downloaded and unzipped the Approval Role files, you can then place the folder
containing the default.php file into your installation of Vanilla. The path to
Approval Role's default.php file should look like this:</p>
<blockquote><code>/path/to/vanilla/extensions/ApprovalRole/default.php</code></blockquote>
<p>Once this is complete, you can enable Approval Role through the "Manage
Extensions" form on the settings tab in Vanilla.</p>

<hr />
<h2 id="use">Using Approval Role</h2>
<p>After enabling Approval Role, you should see on the Membership Applicants
page a new dropdown box labelled "Membership approval role". This is the role
to which your newly approved applicants will be assigned. By default this is
set to the role you specified on the Registration Settings page.</p>
<p>For security reasons you will only see roles of lower priority than your
role. If you want to promote a user to a higher role, you must do it the usual
way through the user's profile page.</p>

<hr />
<h2 id="quirks">Quirks and Gotchas</h2>
<p>This extension may not work correctly in themes other than the default
Vanilla theme. Because the necessary delegate hooks don't exist in the
Membership Applicants form, the select box is hacked onto the end of the
label at the top of the form. Any themes that render this label outside of the
form won't work with this extension.</p>

<hr />
<h2 id="develop">Development</h2>
<p>Approval Role was written by
<a href="mailto:squirrel@digitalsquirrel.com">squirrel</a>. Part of the
<a href="http://code.google.com/p/vanilla-friends/">Vanilla Friends</a>
project.</p>

</body>
</html>

